home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / text / misc / Text_WndV3_7.lha / Deutsch / Text-Wandler.DOK < prev    next >
Text File  |  1994-10-09  |  27KB  |  728 lines
  1.  
  2.  
  3.                Text-Wandler V3.7
  4.              <><><><><><X><><><><>
  5.                       © 1992-1994 von Kai Seidel
  6.  
  7.  
  8. Ein bißchen Theorie:
  9. ********************
  10.  
  11. Da  ich  neben  meinem  Amiga noch einen MS-DOS Rechner für die Bearbeitung
  12. meiner  Mailbox-Programme  & Texte habe, ist es immer lästig, daß die AMIGA
  13. ASCII-Tabelle  nicht  mit  der  IBM-Tabelle übereinstimmt.  Die AMIGA-Texte
  14. sind  auf  einem MS-DOS Rechner (fast) nicht lesbar.  Aus diesem Grund habe
  15. ich  mich  entschlossen  einen  Text-Wandler  zu  schreiben,  der die Texte
  16. zwischen  beiden  ASCII-Formaten  umwandelt.   Ebenso sind die unterschied-
  17. lichen  Zeilenenden  zwischen  MS-DOS  und  AMIGA  ein  Problem.  Der AMIGA
  18. benutzt  ein  $0a  (=Zeilenvorschub)  und  der  MS-DOS  Rechner  ein  $0d0a
  19. (=Wagenrücklauf + Zeilenvorschub) für das Zeilenende.
  20.  
  21.  
  22. Zum Programm:
  23. *************
  24.  
  25. Mein  Programm  behebt  diese  Problematik.   Es  ist in 100% Assembler ge-
  26. schrieben  und nutzt somit die VOLLE Rechnergeschwindigkeit aus.  Es werden
  27. immer  16KByte  (=16384  Bytes) von dem zu wandelnden Text-File eingelesen,
  28. umgewandelt und wieder unter dem neuen Namen abgespeichert.  Es werden aber
  29. nicht  nur  16KByte Speicher vom Programm allokiert.  Insgesamt sollten ca.
  30. 80  KByte  an RAM-Speicher frei sein.  (Fast?) Alle Fehleingaben werden vom
  31. Programm  abgefangen.  Um eine möglichst hohe Geschwindigkeit zu erreichen,
  32. wurden  im  Programm  8 (acht) voneinander getrennte Routinen, zwei für die
  33. Umwandlung  von  Texten  zwischen MS-DOS und Amiga, ebenfalls zwei, für die
  34. Konvertierung   von   Texten   zwischen  Amiga  und  Atari,  eine  für  die
  35. Konvertierung  in  normale  ASCII-Zeichen  (Ä=Ae),  eine für die Entfernung
  36. unbenutzter  Space-  oder Tabulatorzeichen, eine zum Entfernen von lästigen
  37. ANSI-Sequenzen   und  eine  zum  Benutzen  einer  eigenen  Wandlungstabelle
  38. integriert.   Ebenfalls  sind drei komplette ASCII-Tabellen im Programm mit
  39. drin,  die  es  problemlos  ermöglichen,  auch andere Zeichen als >ÄÖÜäöüß<
  40. umzuwandeln.   Das  Programm besitzt ab Version 2.0 einen STARTUP-Code.  Es
  41. kann  seither  also  sowohl  vom  CLI/SHELL  als auch von der Workbench aus
  42. genutzt werden!
  43.  
  44. Der Text-Wandler konvertiert seit der Version 1.4 folgende Sonderzeichen:
  45.  
  46.    ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ
  47.  
  48. Diese  Zeichen  werden  in beide Wandlungs-Richtungen korrekt transferiert.
  49. Leider  sind das auch die einzigen Sonderzeichen, die sowohl in der MS-DOS-
  50. und der AMIGA-ASCII-Tabelle vorhanden sind.
  51.  
  52. Den   Wandlungsablauf   kann   man   mit   der  Tastenkombination  >CTRL-C<
  53. (=Control-Taste  +  C  gleichzeitig)  abbrechen  bzw.  im Fenster-Modus mit
  54. einem Druck auf das Stop-Gadget.
  55.  
  56. Während des Wandlungs-Ablaufes wird die aktuelle Position der Text-Position
  57. angegeben.
  58.  
  59.  
  60. Voraussetzungen an das System:
  61. ******************************
  62.  
  63. Eigentlich  keine  großen.   Der Text-Wandler müßte mit jeder Konfiguration
  64. laufen.  Voraussetzung ist allerdings Kickstart 1.2 oder höher!
  65.  
  66. Kickstart/WB 2.x (Intuition/Gadtools V37 oder höher):
  67.  
  68.   Für  den  Filerequester wird die >ASL.LIBRARY< benötigt.  Diese MUSS sich
  69.   im   "LIBS:"   Verzeichniss   der   Bootdiskette   befinden.    Sie  wird
  70.   normalerweise ab Workbench 2.x mitgeliefert!
  71.  
  72. Kickstart/WB 1.2/1.3:
  73.  
  74.   Für den Filerequester wird die >REQ.LIBRARY< benötigt.  Sollte sich diese
  75.   nicht   im  Archiv  befinden,  sollte  man  mal  auf  den  Fish-Disketten
  76.   nachsehen.  Diese Library muß vor dem Start in das LIBS:  Verzeichnis der
  77.   Workbench  Diskette  bzw.   der  Boot-Partition  kopiert werden!  Ist sie
  78.   nicht vorhanden, kann der Text-Wandler im Workbench-Modus nicht gestartet
  79.   werden (entsprechende Fehlermeldung wird ausgegeben)!
  80.  
  81.  
  82. Installation:
  83. *************
  84.  
  85. Man kopiere die Dateien
  86.  
  87.     Text-Wandler
  88.     und Text-Wandler.info
  89.  
  90. in  ein  beliebiges  Verzeichnis und starte das Programm von der SHELL oder
  91. Workbench aus.
  92.  
  93.  
  94. WORKBENCH-Aufruf:
  95. *****************
  96.  
  97. Ein  Doppelclick  auf das Text-Wandler-Icon und der Textwandler startet mit
  98. der Intuition-Oberfläche (im sog.  Workbench-Modus).
  99.  
  100. Je  nach  Kickstart/Workbench  Version öffnet der Text-Wandler unterschied-
  101. liche Screens und Windows.
  102.  
  103.  
  104. Die Benutzung unter Kickstart/Workbench 1.2/1.3
  105. ***********************************************
  106. Die  Shareware-Version  öffnet zuerst ein INFO-Window.  Das Window kann man
  107. mit   einem   Click   auf   dessen   CLOSE-Gadget  (=Schließ-Schalter)  zum
  108. Verschwinden  bringen.   Es  erscheint  nun  das  eigentliche  Text-Wandler
  109. Fenster mit folgenden Gadgets:
  110.  
  111. - Quell-Datei wählen
  112.  
  113.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  114.   Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  115.   wandelnden Text aussuchen.
  116.  
  117. - Gadget rechts neben >Quell-Datei wählen<
  118.  
  119.   Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  120.   Text-Datei  gewählt  hat, erscheint hier der komplette Filename inclusive
  121.   Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  122.   Gadget clickt.
  123.  
  124. - Ziel-Datei wählen
  125.  
  126.   Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  127.   Files gewählt werden.
  128.  
  129. - Gadget rechts neben >Ziel-Datei wählen<
  130.  
  131.   Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.
  132.  
  133. - Tabelle wählen
  134.  
  135.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  136.   Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  137.   mehr).
  138.  
  139. - Gadget rechts neben >Tabelle wählen<
  140.  
  141.   Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  142.   der Tabelle.
  143.  
  144. - Gadget rechts neben >MODUS<
  145.  
  146.   Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  147.   behandelt werden soll.
  148.  
  149. - OK bzw. STOP
  150.  
  151.   Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  152.   kann   man   mit  OK  den  Konvertierungsvorgang  starten.   Während  des
  153.   Konvertierens  wird  das  OK-Gadget zum STOP-Gadget.  Man kann also durch
  154.   click auf das Stop-Gadget die Konvertierung abbrechen.
  155.  
  156.  
  157. Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
  158. Text-Position, an der der Wandler momentan arbeitet.
  159.  
  160. Treten Fehler auf, so werden diese bei >Status< ausgegeben.
  161.  
  162.  
  163. Die Benutzung unter Kickstart/Workbench 2.x
  164. *******************************************
  165. Der  Text-Wandler  öffnet  einen  Screen  im aktuellen Darstellungsmodi der
  166. Workbench   (PAL/NTSC).    Dazu   ein   Window,  in  dem  die  Gadgets  und
  167. Filerequester  dargestellt werden.  Die Shareware-Version öffnet zuerst ein
  168. INFO-Window.    Das   Window   kann   man   mit   einem  Click  auf  dessen
  169. "WEITER"-Gadget zum Verschwinden bringen.
  170.  
  171. Das Text-Wandler Fenster enthält folgende Gadgets:
  172.  
  173. - Quell-Datei wählen
  174.  
  175.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  176.   Req.library.   Mit  diesem  kann  man  sich  nun  bequem  per Maus den zu
  177.   wandelnden Text aussuchen.
  178.  
  179. - Gadget rechts neben >Quell-Datei wählen<
  180.  
  181.   Dies  ist  ein  sog.   String-Gadget.   Wenn  man  per  Filerequester die
  182.   Text-Datei gewählt hat, erscheint hier der komplette Filename inclusive
  183.   Pfad.   Hier kann man auch per Hand die Eingabe machen, indem man auf das
  184.   Gadget clickt.
  185.  
  186. - Ziel-Datei wählen
  187.  
  188.   Hier kann wieder per Filerequester der Dateiname des fertig konvertierten
  189.   Files gewählt werden.
  190.  
  191. - Gadget rechts neben >Ziel-Datei wählen<
  192.  
  193.   Hier wieder das zugehörige String-Gadget für den Ziel-Datei-Name + Pfad.
  194.  
  195. - Tabelle wählen
  196.  
  197.   Wird   dieses  Gadget  angeclickt,  öffnet  sich  der  Filerequester  der
  198.   Req.library.   Mit  diesem  wählt  man  die Wandlungs-Tabelle (dazu unten
  199.   mehr).
  200.  
  201. - Gadget rechts neben >Tabelle wählen<
  202.  
  203.   Hier  wieder  das zugehörige String-Gadget für den Dateinamen bzw.  -Pfad
  204.   der Tabelle.
  205.  
  206. - Gadget unterhalb >MODUS<
  207.  
  208.   Hier kann der gewünschte Modus eingestellt werden, mit dem der Quell-Text
  209.   behandelt werden soll.
  210.  
  211. - Start/Stop
  212.  
  213.   Wurde  Quell-  und  Ziel-Datei sowie der entsprechende Modus eingestellt,
  214.   kann  mit  "Start/Stop"  der  Konvertierungsvorgang getartet werden.  Man
  215.   kann  also  durch nochmaligen click auf das Stop-Gadget die Konvertierung
  216.   abbrechen.
  217.  
  218.  
  219. Neben  >Position:<  erscheint  während der Konvertierung immer die aktuelle
  220. Text-Position, an der der Wandler momentan arbeitet.
  221.  
  222. Treten Fehler auf, so werden diese bei >Status< ausgegeben.
  223.  
  224. Mit dem Close-Gadget des Windows wird das Programm beendet.
  225.  
  226.  
  227. CLI/SHELL-Aufruf:
  228. *****************
  229.  
  230. Text-Wandler [-i/-a/-m/-t/-s/-c/-u/-r/-z]
  231.          [-o] [-n] <Quell-Datei> <Ziel-Datei> [Tabelle]
  232.  
  233. <> Argumente
  234. [] Optionen
  235.  
  236.  
  237. ARGUMENTE:
  238. **********
  239.  
  240. Die  Argumente  <Quell-Datei>  und  <Ziel-Datei>  MÜSSEN  angegeben werden!
  241. Ausgenommen  ist  die  Anwahl  der  "-u" Option, mit der man die Intuition-
  242. Oberfläche  aufruft!   Andernfalls  bekommt  man  vom Programm eine Fehler-
  243. meldung.  Die Reihenfolge MUß ebenfalls eingehalten werden.
  244.  
  245. Besitzt  ein  File-Name  ein  Leerzeichen,  so muß der gesamte File-Name in
  246. Anführungszeichen stehen!  (siehe Beispiele unten)
  247.  
  248. Man  kann  zusätzlich statt dem Ziel-Dateinamen auch einen Pfad angeben, in
  249. den die Quell-Datei, und mit dem Quell-Dateinamen, konvertiert wird.
  250.  
  251. OPTIONEN:
  252. *********
  253.  
  254.  Von den folgenden neun Optionen kann jeweils immer nur EINE gewählt
  255.  werden:
  256.  
  257. -i  Der  Text  ist  im  AMIGA-ASCII-Format und soll ins MS-DOS-ASCII-Format
  258.     inclusive Sonderzeichenwandlung konvertiert werden.
  259.  
  260. -a  Der  Text  ist  im  MS-DOS-ASCII-Format und soll ins AMIGA-ASCII-Format
  261.     inclusive Sonderzeichenwandlung konvertiert werden.
  262.  
  263. -t  Der  Text  ist im AMIGA-ASCII-Format und soll ins ATARI-ST-ASCII-Format
  264.     inclusive Sonderzeichenwandlung konvertiert werden.
  265.  
  266. -m  Der  Text  ist im ATARI-ST-ASCII-Format und soll ins AMIGA-ASCII-Format
  267.     inclusive Sonderzeichenwandlung konvertiert werden.
  268.  
  269. -s  Der  Text ist  entweder  im AMIGA-ASCII-  oder  im MS-DOS-ASCII-Format.
  270.     Aus   diesem  Text  werden  nun  alle  überflüssigen  Leerzeichen  oder
  271.     Tabulatoren  (siehe  Einschränkungen  der  SHAREWARE  Version)  aus dem
  272.     Quelltext entfernt.
  273.  
  274. -c  Die  im  AMIGA-Text  (!)  enthaltenen  Umlaute  wie ÄÖÜ etc.  werden in
  275.     gewöhnliche ASCII-Zeichen umgewandelt.  Z.B.  >Ä< wird zu >AE<.
  276.  
  277. -u  Der  Text-Wandler springt in den Workbench-Modus.  D.h.  es öffnet sich
  278.     ein Fenster, in dem man sämtliche Optionen per Maus anwählen kann!
  279.  
  280. -r
  281.  
  282.   ANSI-Sequenzen werden hiermit aus AMIGA-Texten herausgelöscht.
  283.  
  284. -z  Benutzt  für den Wandlungsablauf eine Eigene Tabelle.  Ist diese Option
  285.     angewählt,  MUSS  als  dritter  Filename  der Name der Wandlungstabelle
  286.     stehen ([Tabelle])!  Siehe Einschränkungen der SHAREWARE Version!
  287.  
  288.   Wird  keiner  der  oben  angegebenen  OPTIONEN  gewählt, so wird der Text
  289.   automatisch ins MS-DOS-Format konvertiert.
  290.  
  291.  Die restlichen zwei Optionen können, müssen aber nicht angegeben werden:
  292.  
  293. -o  Wenn  ein File mit demselben Namen des angegebenen Ziel-Filenamen schon
  294.     existiert,  so wird bei dieser Option keine Sicherheitsabfrage gemacht,
  295.     ob das File überschrieben werden darf.
  296.  
  297. -n  Schaltet die  Anzeige für die aktuelle  Textposition des Wandelvorgangs
  298.     ab (spart ein paar Zyklen).
  299.  
  300.  
  301. BEISPIELE:
  302. **********
  303.  
  304. Zur Veranschaulichung ein paar Beispiele:
  305.  
  306. 1.  Text  auf Disk in DF0:  Namens "Test.txt" ist im AMIGA-Format  und soll
  307.     ins  MS-DOS-Format konvertiert werden.  Dabei soll der Fertige ins RAM:
  308.     unter dem Namen "Hallo.txt".  Dazu ist folgender Aufruf nötig:
  309.  
  310.    Text-Wandler -i DF0:Test.txt RAM:Hallo.txt
  311.  
  312. 2.  Text  auf  Festplatte DH0:  Namens "Guten Tag.TXT" ist  im AMIGA-Format
  313.     und  soll  ins MS-DOS-Format auf den Datenträger DF2:  mit dem gleichen
  314.     namen konvertiert werden.
  315.  
  316.    Text-Wandler -i "DH0:Guten Tag.TXT" DF2:
  317.  
  318. 3.  Text auf Disk in PC0:  Namens "LESEN.TXT" ist im MS-DOS-Format und soll
  319.     ins  AMIGA-Format  auf  Festplatte WORK:  mit dem Namen "Lies Mich.TXT"
  320.     konvertiert  werden.   Eventuell  schon  vorhandenes  File mit gleichem
  321.     Namen ("Lies Mich.txt") darf gelöscht werden.
  322.  
  323.    Text-Wandler -a-o PC0:LESEN.TXT "WORK:Lies Mich.TXT"
  324.  
  325. 4.  Text  in  RAM:   Namens  "Temp.TXT" im AMIGA- oder  MS-DOS-Format wurde
  326.     gerade   editiert.    Es   sollen   eventuell   vorhandene,  unwichtige
  327.     Leerzeichen  oder  Tabulatoren an den Zeilenenden entfernt werden.  Das
  328.     fertige  File  soll  dann  "RAM:Fertig.TXT"  heißen.   Ebenso  soll die
  329.     Ausgabe   der  aktuellen  Textposition  des  Text-Wandlers  unterdrückt
  330.     werden.
  331.  
  332.    Text-Wandler -s-n RAM:Temp.TXT RAM:Fertig.TXT
  333.  
  334. 5.  Text  auf  Disk DF2:  Namens "Text-Wandler.DOK" im AMIGA- oder  MS-DOS-
  335.     Format,  besitzt Umlaute.  Diese sollen in Normalbuchstaben auf DISK in
  336.     DF1:  mit Namen "TXTWND.DOK" gewandelt werden.
  337.  
  338.    Text-Wandler -c DF2:Text-Wandler.DOK DF1:TXTWND.DOK
  339.  
  340. 6.  Man will den Text-Wandler mit der Intuition-Oberfläche starten und  mit
  341.     dieser sämtliche Eingaben machen.
  342.  
  343.    Text-Wandler -u
  344.  
  345. 7.  Ein  Capture-File  (z.B.   von  JRComm) enthält lästige  ANSI-Sequenzen
  346.     welche  entfernt  werden sollen.  Das File heißt "DF1:Beispiel.CAP" und
  347.     soll ins RAM:  gewandelt werden.
  348.  
  349.    Text-Wandler -r DF1:Beispiel.CAP RAM:
  350.  
  351. 8.  Ein  Text  soll  nach  eigenem Belieben gewandelt werden.  Dazu hat man
  352.     sich eine eigene Tabelle angelegt (siehe unten), die die Buchstaben und
  353.     Sonderzeichen  einfach vertauscht.  Die Tabelle heißt "t:Tab.tab".  Der
  354.     Text,  der  gewandelt werden soll ist im RAM:  und schreibt sich "Hallo
  355.     Herr XYZ".  Der fertige Text soll in das Verzeichniss T:  mit dem Namen
  356.     "Guten_Tag.TXT".
  357.  
  358.    Text-Wandler -z "RAM:Hallo Herr XYZ" T:Guten_Tag.TXT t:Tab.tab
  359.  
  360.  
  361. Die Wandlungstabelle:
  362. *********************
  363.  
  364. Hier  ist nun die Text-Wandler Version, auf die viele Leute gewartet haben!
  365. Ab  Version  3.0  kann der Text-Wandler in sekundenschnelle jeden Text nach
  366. Belieben verunstalten.  Doch nun konkret:
  367.  
  368. Die  CLI/SHELL-Option  "-z"  bzw.   der  Wandlungs-Modus  "Wandlungstabelle
  369. benutzen"  benötigen  eine  sog.   Wandlungs-Tabelle.   Diese hat folgendes
  370. Aussehen:
  371.  
  372. "abc"="def"; /* gewandelt wird >abc< in >def< */
  373. 34,"Hallo",34=">Helau<"; // Hier wird "Hallo" in >Helau< konvertiert
  374. $0a=$0d,$0a; /* Das Amiga-Linefeed wird durch MS-DOS Carriage Return
  375.         und Linefeed ersetzt */
  376. .....
  377. .
  378. .
  379. usw.
  380.  
  381. Es dürfen Strings, Hex- und Dezimalzahlen angegeben werden.  Strings müssen
  382. in   Anführungszeichen   gesetzt   werden   und   Hexzahlen  benötigen  ein
  383. Dollarzeichen vor der Zahl.
  384.  
  385. Das   'Istgleichzeichen'   "="   trennt   die  beiden  Zeichen(folgen)  die
  386. konvertiert werden sollen.  Am Ende benötigt der Text-Wandler ein Semikolon
  387. ";" um das Ende einer Definition zu markieren.
  388.  
  389. Kommentare  sind nun auch möglich.  Entweder normale C- oder C++ Kommentare
  390. dürfen  angegeben  werden, wobei erstere mit der Zeichenfolge "/*" beginnen
  391. und  mit  "*/"  Enden.   C++ Kommentare beginnen mit "//" und Enden mit dem
  392. Zeilenende !
  393.  
  394. Zum genaueren Verständnis ein paar Beispiele:
  395.  
  396. Der  Buchstabe  "a"  (klein  a)  soll  im Text in ein GROSSES "A" gewandelt
  397. werden.  Dazu kann man folgende Kombinationen benutzen:
  398.  
  399.   $61=$41;
  400.    oder
  401.   "a"="A";
  402.    oder
  403.   97=$41;
  404.    etc.
  405.  
  406. Die Zeichen "-" und "+" sollen miteinander vertauscht werden:
  407.  
  408.   $2B=$2D;
  409.   $2D=$2B;
  410.    oder
  411.   "-"="+";
  412.   "+"="-";
  413.    etc.
  414.  
  415. Alle Leerzeichen sollen mit einem "_" ersetzt werden:
  416.  
  417.   $20=$5F;
  418.    oder
  419.   32="_";
  420.  
  421. Jedes "!" soll eliminiert werden:
  422.  
  423.   "!"=;
  424.  
  425.  
  426. Natürlich  kann  man  sich  hiermit eine ganz eigenen ASCII-Zeichensatz zu-
  427. sammenstellen.
  428.  
  429. Noch ein wichtiger Tip:
  430. Beim Erstellen eigener Tabellen muß darauf geachtet werden, daß längere, zu
  431. ersetzende  Zeichenfolgen  vor  Zeichenfolgen  mit  gleichem  Anfang in der
  432. Tabelle  erscheinen.   Das  liegt  daran,  daß der Text-Wandler intern eine
  433. Tabelle   aufbaut,   die   er   von  vorn  durchscannt  und  dann  erkannte
  434. Zeichen(folgen) ersetzt.  Ein Beispiel dazu:
  435.  
  436. "+"="-";
  437. "++"="+";
  438.  
  439. Hier  würde  der Text-Wandler alle Pluszeichen durch Minuszeichen ersetzen,
  440. ohne  Zeile  2  zu beachten.  Damit dies nicht vorkommt, muß man die Zeilen
  441. vertauschen!
  442.  
  443. "++"="+";
  444. "+"="-";
  445.  
  446.  
  447. Fehlermeldungen:
  448. ****************
  449.  
  450. Für folgende Fehleingaben/Probleme existieren Fehlermeldungen:
  451.  
  452. - Keine Angaben gemacht
  453. - Falsche/Keine Option(en) angegeben
  454. - Keine oder nur ein Filename wurde angegeben
  455. - Quell- und Ziel-Dateinamen sind gleich *)
  456. - Quell-Datei nicht vorhanden
  457. - Ziel-Datei bereits vorhanden *)
  458. - Ziel-Datei-Pfad unzulässig
  459. - nicht genügend Speicher vorhanden
  460. - Fehler beim lesen/schreiben des Quell-/Zielfiles
  461. - Angabe der unkorrekten Zeile der Wandlungstabelle
  462.  
  463. ACHTUNG !!! Die mit *) gekennzeichneten Fehlermeldungen werden bei
  464. der Benutzung der Intuition-Oberfläche >NICHT< gemacht !!!
  465.  
  466.  
  467. Tips zum Wandeln:
  468. *****************
  469.  
  470. Um längere Texte zu wandeln ist es ratsam diese ins RAM zu kopieren, sofern
  471. dieser groß genug ist, und die Texte von dort aus wandeln zu lassen, da die
  472. Zugriffsgeschwindigkeit   der   Laufwerke   auf   Diskette   nicht   gerade
  473. überwältigend ist.
  474.  
  475. Die   Switches  kann  man  an  beliebiger  Stelle  setzen!   Lediglich  die
  476. Reihenfolge   der  QUELL-File-,  ZIEL-File-  und  Tabellen-File  Namen  muß
  477. eingehalten werden!
  478.  
  479.  
  480. Bekannte Fehler:
  481. ****************
  482.  
  483. Wie immer: KEINE BEKANNT
  484.  
  485. Die  groben  BUG's  werden  vor  Ausgabe der neusten Version immer behoben.
  486. Meist  sind  es  jedoch  die  kleinen,  fiesen, die man erst durch längeres
  487. Arbeiten mit dem Text-Wandler erkennt.
  488.  
  489. Trotzdem  versuche  ich  die  erkannten  Fehler  sofort aus dem Programm zu
  490. entfernen!
  491.  
  492.  
  493. Für die Zukunft:
  494. ****************
  495.  
  496. - Text-Wandler erkennt selbständig, ob es sich beim Quell-File um einen
  497.   AMIGA- oder MS-DOS-Text handelt
  498. - 8 Spaces werden zu einem TAB konvertiert
  499. - Tabellen-Wandlungs-Routine wird optimiert
  500.  
  501.  
  502. Wichtige Informationen:
  503. ***********************
  504.  
  505.   Es wird weder eine Garantie für die vollständige Funktionsfähigkeit, noch
  506.   die juristische Verantwortung oder irgendeine Haftung für Folgen, die auf
  507.   fehlerhafte  Angaben  bzw.   die  Benutzung  des  Programms  zurückgehen,
  508.   übernommen.  Sie nutzen diese Software auf eigenes Risiko!
  509.  
  510.  
  511. Falls Fehler auftreten:
  512. ***********************
  513.  
  514. Dann  bitte  an  mich  eine Message mit möglichst genauem Fehler-Report per
  515. ZERBERUS-Netz an SYSOP@CHIEMGAU.zer.sub.org oder an folgenden Adresse:
  516.  
  517. Kai Seidel
  518. Traunsteiner Str. 19
  519. 83355 Grabenstaett
  520. GERMANY
  521.  
  522. oder per Telefon: +49 (0)8661 8087 (privat)
  523.           +49 (0)8661 8104 (Mailbox - 18-6 Uhr Online; 1200-28800 Baud)
  524.  
  525. Wenn  Du  Verbesserungsvorschläge hast, dann schreib mir doch, ruf mich an,
  526. oder schreib mir ne Nachricht übers Z-NETZ an SYSOP@CHIEMGAU.zer.sub.org.
  527.  
  528.  
  529. Einschränkungen der SHAREWARE Version:
  530. **************************************
  531.  
  532. Die   Routine,   die  unbenuzte  Spaces  am  Zeilenende  löscht,  kann  nur
  533. AMIGA-Texte korrekt wandeln.  Ebenso werden NUR Spaces gelöscht, nicht aber
  534. Tabulatoren!  Das "ß" wird bei der Option "-c" nicht mitgewandelt.
  535.  
  536. Beim  Aufruf  unter  Intuition  ist  eine  Art  Nerv-Requester  in Form der
  537. Shareware-Information eingebaut.
  538.  
  539. Die  Modi  "ANSI-Remove"  und "Wandlungs-Tabelle benutzen" sind nur von der
  540. Intuition-Oberfläche aus abrufbar !
  541.  
  542. Bei  der  Konvertierung  von Texten mit Hilfe von selbsdefinierten Tabellen
  543. werden  maximal  32 Zeichen eingelesen !  Deshalb bitte nicht wundern, wenn
  544. der  Textwandler  beim  Parsen  einen  Fehler  ausgibt!  Folgende Zeile ist
  545. möglich:
  546.  
  547. "ä"="ae";"ö"="oe";"ü"="ue";
  548.  
  549. Das sind 28 Zeichen, was zum Testen vorerst ausreichen sollte!
  550.  
  551. Diese Einschränkungen sind in der VOLLVERSION natürlich aufgehoben.
  552.  
  553.  
  554. SHAREWARE-GEBÜHR/REGISTRIERUNG:
  555. *******************************
  556.  
  557. Solltest du an dem Programm Gefallen finden oder du es öfter benutzen, dann
  558. fände  ich  es  fair,  mir 15,- DM für die registrierte Version zukommen zu
  559. lassen.
  560.  
  561. Für  die  Registrierung  drucke  bitte das File "Registrierung.TXT" aus und
  562. schicke  es  mir  ausgefüllt  an die angegebene Adresse.  Solltest du keine
  563. Druckmöglichkeit    haben,    dann    schreibe    die   Adresse,   Tel-Nr.,
  564. Computerkonfiguration  und  gewünschte Zahlungsart auf einen Zettel, den Du
  565. mir  dann  zusendest.   Für  Überweisungen  benutze  bitte  die  angegebene
  566. Konto-Nr.  im Registrierungsformular.
  567.  
  568. Bisher  registrierte Benutzer müssen nichts draufzahlen !!!  Sie haben also
  569. den  Vorteil  durch  ihre frühe Registrierung immer die aktuellen Versionen
  570. umsonst zu bekommen!
  571.  
  572. Du  bist  dann  berechtigt, immer die neuste Version nutzen zu dürfen!  Die
  573. NEUSTE  VERSION  bekommst  Du  von  mir  entweder  in  meiner Mailbox (Tel.
  574. 08661-8104  ab  18  Uhr),  oder  Du schickst mir einen frankierten, an Dich
  575. adressierten  Rückumschlag  MIT  Diskette,  den ich umgehend mit der neuen,
  576. registrierten Text-Wandler-Version zurücksende!
  577.  
  578.  
  579. Verbreitungs- & Copyright-Hinweise:
  580. ***********************************
  581.  
  582. Betrifft nur die SHAREWARE-Version:
  583.  
  584.  Das  Programm  darf  NUR  in  Verbindung  mit  dieser  Anleitung  und  dem
  585.  Registrierungsformular    für   eine   Höchstgebühr   von   4,-   DM   für
  586.  Bearbeitungs-/Kopiergebühren weitergegeben werden!
  587.  
  588.  Diese Shareware-Version darf von jeder PD-Serie aufgenommen werden.
  589.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  590.  
  591. Betreffend der VOLLVERSION (=registrierte Version):
  592.  
  593.  Die  registrierte  Version  darf  NICHT  weitergegeben  oder auf PD-Serien
  594.  angeboten  werden!   Ebenso  ist es den REGISTRIERTEN Benutzern untersagt,
  595.  ihre Version an Dritte weiterzugeben!
  596.  
  597.  Die Req.Library ist Copyrighted von Colin Fox und Bruce Dawson!
  598.  
  599.  Die ReqTools.Library ist Copyrighted von Nico François!
  600.  
  601.  
  602. Speziellen Dank:
  603. ****************
  604.  
  605.  ...    an  meinen  Bruder  Roger  und  seinen  Freund  für  die  englische
  606.         Übersetzung und das Korrekturlesen der Dokumentation!
  607.  
  608.  ...    an   Ralph   Babel   und   Garry   Glendown   für   die  Hilfe  bei
  609.         programmtechnischen Fragen!
  610.  
  611.  ...    an Colin Fox und Bruce Dawson für ihre großartige req.library!
  612.  
  613.  ...    an Nico François für seine spitzen ReqTools.library!
  614.  
  615.  ...    und an  Commodore für die Produktion dieses Superrechners, denn nur
  616.         AMIGA macht's möglich !!!
  617.  
  618.  
  619. Entwicklungs-Phasen:
  620. ********************
  621.  
  622. V1.0    Erste Version vom 25.4.92
  623. V1.1    Version vom 1.5.92
  624.     -Unterstützung von Filenamen mit Leerzeichen durch Angabe mit
  625.      Anführungszeichen eingebaut
  626.     -Test, auf zwei gleiche Filenamen eingebaut
  627. V1.2    Version vom 3.7.92
  628.     -Schweren BUG beim Wandeln in Richtung IBM-Format entfernt!
  629.     -Speicher-Allokier-Routine verschoben -> noch kürzere Wandlungs-
  630.      zeiten!
  631.     -Zusätzliche Optimierungen vorgenommen (beq.s, moveq ect.)
  632. V1.2a   Version vom 6.7.92
  633.     -Falschen USAGE-Text berichtigt
  634. V1.3    Version vom 11.7.92
  635.     -Wandel-Puffer wurde auf 16384 heruntergesetzt.
  636.     -Weiteren Wandel-BUG behoben; Probleme gab's beim Wandeln von
  637.      IBM-Texten ins AMIGA-Format. Die Returns ($0d0a), die durch den
  638.      Puffer von 16384 getrennt werden, werden jetzt auch richtig
  639.      gewandelt!
  640.     -Weitere Optimierungen vorgenommen; Die Anzahl der Lade-Bytes und
  641.      der Bytes, die gespeichert werden, ist gleich -> SUPERKURZE
  642.      Wandlungszeiten auch von Festplatte auf Festplatte!
  643.     -BUG, der ein einwandfreies Funktionieren unter Kick 1.2/1.3
  644.      verhindert, in letzter Minute entfernt.
  645. V1.4    Version vom 21.7.92
  646.     -Zusätzliche Sonderzeichen werden, neben den Umlauten, jetzt auch
  647.      gewandelt (siehe oben).
  648. V1.5    Version vom 24.7.92
  649.     -Die Verwechslung des Zeichens "ª" mit "|" in der Version 1.4 wurde
  650.      berichtigt (ist für die Konvertierung von z.B. C-Sourcen wichtig).
  651.     -Bei Angabe eines Directories statt dem Ziel-Namen, wird der Text
  652.      mit dem Quell-Namen dorthin konvertiert.
  653.     -Sicherheitsabfrage bei bereits existierenden Ziel-File eingebaut.
  654.     -Neuen Switch (-o) eingebaut, der die Sicherheitsabfrage auf Exis-
  655.      tenz eines Files mit gleichem Namen wie der Ziel-File-Name, ab-
  656.      schaltet.
  657.     -Ohne Angabe eines Switches wird der Text nun ins MS-DOS-Format
  658.      konvertiert.
  659. V1.6    Version vom 11.8.92  PROGRAMMLÄNGE: 4756 Bytes
  660.     -Optimierungen vorgenommen -> kürzerer Code!
  661.     -Der Wandler ist nun mit CTRL-C abbrechbar !
  662.     -Eine Anzeige, um die aktuelle Zahl der bereits gewandelten Bytes
  663.      auszugeben, wurde eingebaut; sie läßt sich mit dem -n Switch
  664.      abschalten.
  665.     -Neuer Switch, um unnötige Spaces bzw. Tabs am Zeilenende zu
  666.      entfernen, eingebaut.
  667. V1.7    Version vom 13.8.92  PROGRAMMLÄNGE: 5160 Bytes
  668.     -Beim Wandeln ins AMIGA-Format wurde das 1. Zeichen des Textes
  669.      überlesen. Dieser Bug wurde entfernt!
  670.     -Mit der -c Option werden Umlaute wie z.B. >Ö< in >Oe< gewandelt.
  671. V2.0    Version vom 10.9.92  PROGRAMMLÄNGE: 11280 Bytes
  672.     -Komplette, mausorientierte Intuitionoberfläche hinzugefügt
  673.      -> alles per Maus steuerbar !
  674. V2.1    Version vom 23.9.92  PROGRAMMLÄNGE: 11864 Bytes
  675.     -Bug beim Wandeln von MS-DOS-Text in Amiga-Text entfernt:
  676.      IBM-Return wird auf 0x0d0a jetzt getestet!
  677.     -ANSI-Remover eingebaut. Lästige ANSI-Sequenzen können nun pro-
  678.      blemlos entfernt werden!
  679. V2.2    Version vom 22.11.92 PROGRAMMLÄNGE: 13248 Bytes
  680.     -Unter Kickstart 1.x funktionierte das String-Gadget nicht korrekt.
  681.      Bug behoben!
  682.     -Wandlungsrichtung für ATARI-ASCII-Texte mit implementiert!
  683.     -Versions-String eingebaut - Damit läßt sich jetzt auch mit dem
  684.      CLI/SHELL-Befehl "VERSION Text-Wandler" die aktuelle Version des
  685.      Text-Wandlers abfragen.
  686.     -Der USAGE-Text (beim Aufruf mit "?") wird nun in 12'er Zeilen
  687.      ausgegeben und auf die RETURN-Taste gewartet.
  688. V2.2a   Version vom 30.11.92 PROGRAMMLÄNGE: 13256 Bytes
  689.     -Mehrere Bugs wurden behoben:
  690.      + Der ANSI-Remover funktioniert jetzt wieder !
  691.      + Bei der Frage, ob das schon vorhandenen Ziel-File überschrie-
  692.        ben werden soll, wurde bei Eingabe von "J" oder "N" + RETURN
  693.        das Return ueberlesen!
  694. V2.3    Version vom 06.12.92 PROGRAMMLÄNGE: 13248 Bytes
  695.     -Das "STOP"-Gadget lief nicht ordnungsgemäß! Der Computer ist
  696.      daraufhin immer abgestuerzt ! Bug behoben!
  697.     -Zu lange ANSI-Sequenzen wurden nicht herausgefiltert! Auch dieser
  698.      Bug wurde behoben !
  699. V3.0    Version vom 15.1.93 PROGRAMMLÄNGE: 20764 Bytes
  700.     -OS 2.x Benutzeroberfläche eingebaut!
  701.     -Option zum Wandeln mit eigener Tabelle eingebaut!
  702.     -String-Gadget-Bug unter Kick/WB 1.2/1.3 behoben!
  703. V3.1    Version vom 22.2.93 PROGRAMMLÄNGE: 21128 Bytes
  704.     -Der Usage-Text paßt sich nun der Fensterhöhe an. D.H. die Ausgabe
  705.      stoppt automatisch, wenn das Fenster voll ist.
  706.     -Unter der Intuition-Oberfläche waren einige Wandlungsarten ver-
  707.      tauscht! Fehler behoben!
  708. V3.5    Version vom 27.3.94 PROGRAMMLÄNGE: 23576 (Deutsche Version)
  709.                        23132 (Englische Version)
  710.     -Ab sofort gibt es eine Deutsche und eine Englische Version!
  711.     -Die Wandlungstabelle darf jetzt neben HEX- auch Dezimalzahlen
  712.      und Strings enthalten
  713.     -Es werden jetzt nicht mehr Zeichen 1:1 über die Tabelle gewandelt,
  714.      sondern beliebig viele Zeichen können zu beliebig vielen kon-
  715.      vertiert werden!
  716. V3.6    Version vom 21.5.94 PROGRAMMLÄNGE: 23948 (Deutsche Version)
  717.                        23500 (Englische Version)
  718.     -Das "ß" wurde in "us" gewandelt !!! Bug behoben
  719.     -Das CLI-Window wird nun auf RAW geschaltet, damit lassen sich
  720.      bei der Abfrage auch einzelne Zeichen lesen!
  721.     -Wird die Ausgabe beim CLI-Aufruf auf ein File umgeleitet, wird
  722.      ein evtl. vorhandenes Zielfile trotzdem ueberschrieben (fuer
  723.      automatisierte Aufrufe, z.B. beim Einsatz in Mailboxen)
  724. V3.7    Version vom 09.10.94 PROGRAMMLÄNGE: 23604 (Deutsche Version)
  725.                         23112 (Englische Version)
  726.     -Tabellen-Wandlungs-Routine erheblich verbessert!
  727.     -Allgemeiner konvertierungs-Bug behoben
  728.